home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / comm / uucp / DanNews13.lha / DanNews13 / ReadMe < prev    next >
Text File  |  1995-07-23  |  8KB  |  191 lines
  1. DanNews - another throbbing Blender Software (BS) production
  2. ------------------------------------------------------------
  3.  
  4. This is DanNews, a NNTP/UUCP news unbatcher. Unlike RNews it's fast and it
  5. only takes as much memory as you let it.
  6.  
  7. The bad points are that it can't send articles on to other sites and it can't
  8. handle compressed batch files. That doesn't matter if you get your news feed
  9. through NNTP but it's not so good if you get your news through UUCP.
  10.  
  11.  
  12. What you need
  13. -------------
  14.  
  15. Kickstart 2 or above, a news set up that uses the UUNEWS: way of storing news
  16. articles, and a batch file (natch).
  17.  
  18.  
  19. Installing
  20. ----------
  21.  
  22. - Copy DanNews to UUC:. Don't delete RNews because some programs may still
  23.   want to use it. Also don't edit the RNews entry in UULIB:Config to point
  24.   to DanNews because DanNews can't post news, it's just an unbatcher.
  25. - Create the file UULIB:sitename or UUCP:sitename to hold your full site name
  26.   (eg. mine's 'blender.demon.co.uk') needed for the PATH and XREF options. It
  27.   doesn't matter which one you use, but I included both because the Tin
  28.   newsreader also uses this way to work out the site name (earlier versions
  29.   of Tin used UUCP:sitename, later versions use UULIB:sitename).
  30. - Depending on your set up, you may need to alter other scripts which call
  31.   RNews to call to DanNews.
  32.  
  33.  
  34. Extra stuff for AmigaDIS set up (version 3 or above)
  35. ----------------------------------------------------
  36.  
  37. - If you want to change the options, edit the DanNews line in DIS:C/NewsRead
  38.   and type ReProtect after saving.
  39.  
  40.  
  41. Extra stuff for AmigaDIS set up (version 2 or below)
  42. ----------------------------------------------------
  43.  
  44. - Edit DIS:Read_News and replace RNews with DanNews. If you want you can also
  45.   put in some of the options (explained further on).
  46. - It's a good idea to wipe the command that deletes the batch file in the
  47.   line afterwards and use the DELETE option (further down) instead.
  48. - It's done. Have a Fruit Corner with dark and milk chocolate covered puffed
  49.   rice (yum).
  50.  
  51.  
  52. Extra stuff for AmiTCP-DIS set up
  53. ---------------------------------
  54.  
  55. - Same as above, but edit AmiTCP:bin/NNTPTransfer instead. Type 'protect
  56.   NNTPTransfer srwd' afterwards if your editor messed around with the
  57.   protection bits.
  58. - If you use PLink to dial up Demon instead of the normal Link than you'll
  59.   have to edit that instead. And protect it afterwards, mind.
  60.  
  61.  
  62. Options
  63. -------
  64.  
  65. - DanNews FILE,BLIP/K/N,CACHE/K/N,DELETE/S,DELETEOVERVIEW/S,PATH/S,STATS/S,
  66.           XREF/S,-1/S,-H/S,-N/S,-T/K
  67.   The single character options are compatible with RNews.
  68.  
  69. - FILE
  70.   The file to unbatch. If you don't give a file then stdin is used instead.
  71.   This means that other programs can pipe stuff to it. But it's slower.
  72. - BLIP/K/N
  73.   Shows a display of how long there is to go before the unbatch is finished.
  74.   The number is how many articles are unbatched before the display's updated.
  75.   Not enough and you might slow down the computer with too much printing on
  76.   the screen. Too much and it's not very useful. I use 50.
  77. - CACHE/K/N
  78.   The maximum amount that it can allocate to the cache. If it's positive then
  79.   the cache will not go above that size - it could very well be less. If it's
  80.   negative then the cache will be at most that much less than the largest
  81.   block of memory you have (check with avail). The default is -100000.
  82. - DELETE/S
  83.   Delete the batch file after a successful unbatch but keep it there if there
  84.   was an error. If you run a script from a Workbench icon to unbatch any new
  85.   news and delete the batch file afterwards then it's probably a good idea to
  86.   remove the delete command and set this switch instead. That way you have a
  87.   chance to see what's wrong instead of watching in horror as IconX carefully
  88.   deletes your last news download.
  89. - DELETEOVERVIEW/S
  90.   Found out by accident that Tin 1.3 beta seems a lot faster if you delete
  91.   the .overview files and let it recreate them from scratch after each news
  92.   unbatch. So, I added a new option to do this.
  93. - PATH/S
  94.   Alters the 'Path' header so that your site is put on last in the list. You
  95.   have to have your sitename set up properly for this to work.
  96. - STATS/S
  97.   Display some funky statistics for each group when the unbatch has finished.
  98. - XREF/S
  99.   Switch on cross referencing stuff. This means it makes Xref headers that
  100.   let your newsreader automatically skip reading crossposted articles for the
  101.   second or third or so on groups. You have to have your sitename set up
  102.   properly for this to work.
  103. - -1/S
  104.   For crossposted articles, only unbatch the article to the first group in
  105.   the 'Newsgroups' header (or if that one isn't in UULIB:newsgroups then go
  106.   through the header and find the first one which is and unbatch to that
  107.   group instead).
  108. - -H/S
  109.   For crossposted articles, disable hardlinks. They're useful because the
  110.   second, third, etc... copies of articles in the 'Newsgroups' header are
  111.   really only pointers to the original, not complete copies. That means that
  112.   only a few of bytes of disk space are used instead of a few K. But if you
  113.   don't use a file system that supports hardlinks (ie. not FFS) then you get
  114.   problems instead. But it serves you right for not using FFS...
  115. - -N/S
  116.   Don't bother unbatching the file, but run through the program anyway. Maybe
  117.   useful if you want to test if the batch file's corrupt or to see how big
  118.   the unbatch will be with the STATS option or something.
  119. - -T/K
  120.   If you unbatch from stdin then a tempory work file is made in T:. You can
  121.   change the directory of it by using this though.
  122.  
  123.  
  124. Examples
  125. --------
  126.  
  127. - DanNews TCPIP:Spool/News/batch delete -h
  128. - DanNews TCPIP:Spool/News/batch cache 100000 path xref
  129. - DanNews TCPIP:Spool/News/batch cache -500000 stats -n
  130. - DanNews <PIPE: -t Work:TempDir
  131.  
  132.  
  133. Hints 'n' stuff
  134. ---------------
  135.  
  136. The cache must be at least the size of the largest article, otherwise DanNews
  137. stop with an error.
  138.  
  139. It's picky about download errors. If your news download stops early because
  140. of an error, it's a good idea to rename the corrupt batch file to something
  141. else before restarting the download. That way the corrupt article will be at
  142. the end of the file and you can easily delete it by loading it into an editor
  143. that doesn't expand or compress spaces or tabs. If you forget to do this then
  144. you'll still have an idea of where the corrupt article is because you'll be
  145. told the offset into the file.
  146.  
  147. The program can unbatch control messages. If a message has a 'Control' header
  148. then it's unbatched to the group control.<name>, for example control.newgroup
  149. or control.rmgroup. But you've also got to put the group names of the control
  150. messages you're bothered about into UULIB:newsgroups (or UULIB:DanNewsGroups)
  151. otherwise they'll get thrown into junk. The full list of control messages are
  152. cancel, ihave, sendme, newgroup, rmgroup, sendsys, version, and checkgroups.
  153.  
  154. If you want, you can list some more groups in UULIB:DanNewsGroups. It's in
  155. the same format as UULIB:newsgroups. It lets you define groups that you don't
  156. want your newsreader to show (eg. control groups). But remember that TrimNews
  157. doesn't trim the groups listed in UULIB:DanNewsGroups, so you've got to sort
  158. that one out yourself.
  159.  
  160. The junk group is where articles go when the they're in none of the other
  161. groups listed in UULIB:newsgroups (or UULIB:DanNewsGroups).
  162.  
  163.  
  164. Bugs
  165. ----
  166.  
  167. If you hit CTRL-C then you'll interrupt the unbatching before the .next files
  168. have been updated, so if you unbatch again you overwrite all of the articles
  169. that were created during the interrupted unbatch. But then again this isn't
  170. so bad 'cos you don't get duplicate articles if you unbatch the same batch
  171. file again (which you probably will do).
  172.  
  173.  
  174. And finally...
  175. --------------
  176.  
  177. This is copyrighted by me but freely distributible. It shouldn't be altered
  178. in any way and you should only charge for disks, postage, or packing if you
  179. charge anything.
  180.  
  181. If it trashes your news or blows up your computer or destroys the fabric of
  182. the universe or something then consider yourself warned. Use at your own risk
  183. and all that. But I trust it enough to use it.
  184.  
  185. And it can't be used as part of anything that's sold for profit without my
  186. say so. So there.
  187.  
  188. My Email address is dan@blender.demon.co.uk, if you spot a bug or something.
  189.  
  190. Dan.
  191.